home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 003 / bulktext / !BulkSplit / !Help next >
Text File  |  1994-05-03  |  3KB  |  81 lines
  1. BulkSplit  -  reverse action of BulkJoin
  2. ----------------------------------------
  3.  
  4. This application takes a "bulktext" file and splits it
  5. up into the individual component files. The file may
  6. have been created by the Archimedes version of the
  7. BulkJoin application, but may also have been created by
  8. the mainframe version of BulkJoin and then downloaded
  9. (in which case the download file transfer program must
  10. convert from EBCDIC to ASCII coding as necessary).
  11. BulkSplit also converts DOS CRLF end of line codes to
  12. the Archimedes standard of LF.
  13.  
  14. How to use BulkSplit
  15. --------------------
  16. Install the BulkSplit icon on the icon bar in the usual
  17. way. Click select once on the icon to open the setup
  18. dialog box. Drag the input "bulktext" file to the box
  19. labelled "Input" and the directory where the output
  20. files are to be created, to the box labelled "Output".
  21. Enter the file-type to be assigned to the created files
  22. in the box labelled "Output file type" - this can be in
  23. either hex (e.g. ffd) or text (e.g. "data"). Specify the
  24. maximum file size (used when obtaining a work buffer) in
  25. the box labelled "Max output file size". Then click on
  26. the "Run" button to start processing.
  27.  
  28. Using BulkSplit from the Command line
  29. -------------------------------------
  30. BulkSplit can also be used from the command line (or
  31. more likely, from within command scripts).
  32.  
  33. Syntax:  *BulkSplit bulktextfile outputdir [options]
  34.  
  35.          options can be one or more of the following:
  36.  
  37.          -b nnnn  - specifies the maximum output file
  38.                     size in K.
  39.  
  40.          -t xxxx  - specifies the output file type as
  41.                     text or in hexadecimal.
  42.  
  43. Technical information
  44. ---------------------
  45. BulkSplit recognises special markers in the input file
  46. which indicate the start of the next "file". These
  47. markers are created by BulkJoin and have the format:
  48.  
  49.      @@@@---> filename
  50.  
  51. If any of the data in the file happens to include a line
  52. starting with "@@@@--->", then BulkSplit will be fooled
  53. into thinking it is the start of a new "file".
  54.  
  55. BulkSplit was written in C and compiled with the
  56. AcornSoft ANSI C Compiler Version 4. It requires the
  57. Acorn Floating Pointer Emulator and Shared C Library
  58. relocatable modules to be installed. The !BulkSplit
  59. application runs under the Acorn DDE environment.
  60.  
  61. Copyright notice
  62. ----------------
  63. BulkSplit is FREEWARE. The copyright remains with Paul
  64. Witheridge.
  65.  
  66. Permission is granted by the author to any recipient of
  67. this material to use and make/disseminate copies of the
  68. application provided that no charges are made for doing
  69. so except (a) to cover any cost of media or postage, or
  70. (b) nominal fees levied by public domain libraries, and
  71. that this notice is included with all copies.
  72.  
  73. Paul Witheridge
  74. 1 Ragmans Close
  75. Marlow Bottom
  76. Marlow
  77. Bucks
  78. SL7 3QW
  79.  
  80. 27 July 1993
  81.